home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / rfileu10.zip / TEE.DOC < prev    next >
Text File  |  1993-05-06  |  4KB  |  104 lines
  1.  
  2.  
  3.                             #######                
  4.                                #     ######  ######
  5.                                #     #       #     
  6.                                #     #####   ##### 
  7.                                #     #       #     
  8.                                #     #       #     
  9.                                #     ######  ######
  10.  
  11.  
  12.  
  13.  
  14. You can get part of the following documentation by invoking the program with
  15. the switches -v, -h, or -H . See README.TXT for more information.
  16.  
  17. -----------------------------------   -v   ------------------------------------
  18. TEE v1.0 -- Duplicate output to a file
  19. Copr (c) 1992,1993 Richard Breuer. TEE is freeware. No warranties.
  20.  
  21. This is TEE/2 v1.0 - renamed to TEE (from RUTILS 4).
  22.  
  23. Author: Richard Breuer
  24.         Brunssumstrasse 6
  25.         5100 Aachen
  26.         (after Jul 1, 1993: 52074 Aachen)
  27.         Germany
  28.         Europe
  29.  
  30. Phone:  +49/241/85605
  31. Fax:    +49/241/8021329
  32.  
  33. Email:  ricki@pool.informatik.rwth-aachen.de (Preferred!)
  34.  
  35. -----------------------------------   -h   ------------------------------------
  36. TEE v1.0 -- Duplicate output to a file
  37. Copr (c) 1992,1993 Richard Breuer. TEE is freeware. No warranties.
  38.  
  39. Usage:
  40.    TEE [-acChHv*] outfile infile.. [{>|>>} outfile2]
  41.  
  42. Notes:
  43.    (1) outfile is required and may not contain wildcard characters
  44.    (2) TEE OVERWRITES outfile1 WITHOUT ASKING, if -a is not given!
  45.        Be careful! You have been warned! Twice!!
  46.  
  47. Options:
  48.    -a  Append output to outfile. Default is overwrite
  49.    -c  Binary copy mode. TEE creates an exact copy of the input files
  50.    -C  Text copy mode. TEE treats input and output files as text files
  51.    -h  Display this help screen
  52.    -H  Display another help screen with notes and examples
  53.    -v  Display version info and information about the author
  54.    -*  Display internal information (for debugging purposes)
  55.  
  56. -----------------------------------   -H   ------------------------------------
  57. TEE v1.0 -- Duplicate output to a file
  58. Copr (c) 1992,1993 Richard Breuer. TEE is freeware. No warranties.
  59.  
  60. Notes:
  61.    TEE reads from stdin if a filename is -. The output is always directed
  62.    to stdout. The errorlevel is set to 1 if help has been displayed. It is set
  63.    to 255 in case of an error and 0 on normal completion. Output resulting from
  64.    multiple input files is appended to stdout. The processing order for wild-
  65.    cards depends on the order of the directory entries. TEE does work for
  66.    binary files. In text mode lines longer than 255 characters are truncated.
  67.  
  68. Examples:
  69.    TEE ALL.TXT *.TXT
  70.       Process all *.TXT files in the current directory and append them to
  71.       stdout as well as writing them to ALL.TXT. The order is the one DOS's dir
  72.       tells you.
  73.    TEE MYLIB.TPL \MYLIB\*.TPU
  74.       Creates a Turbo Pascal Library file from all TPU's in \MYLIB.
  75.  
  76. -------------------------------------------------------------------------------
  77. Additional information:
  78.    TEE is a re-implementation of the Unix command with the same name.
  79.  
  80.    4DOS users should be aware of the fact that TEE is a 4DOS command. Therefore
  81.    you must explicitly start TEE.EXE to let it run instead of 4DOS' TEE. An
  82.    alternative is, of course, to rename it.
  83.  
  84.    TEE is much faster than 4DOS' TEE and works for binary files, too.
  85.  
  86. Examples:
  87.    The following examples illustrate the use of TEE:
  88.  
  89.    DIR | TEE DIR.LST
  90.      displays the directory and writes (at the same time) the directory to
  91.      DIR.LST. TEE works in text mode, ie. it reads the output of dir line by
  92.      line and writes it line by line to stdout and DIR.LST
  93.  
  94.    DIR | TEE DIR.LST > DIR2.LST
  95.      does principally the same as before, internally however the behaviour is
  96.      completely different. TEE detects that the output is redirected to a file
  97.      and can therefore switch to binary mode, which is faster than text mode.
  98.      DIR.LST and DIR2.LST have exactly the same contents after this call.
  99.  
  100.      You may override the automatic mode detection (text or binary mode) with
  101.      the options -c (force binary) and -C (force text). See CAT.DOC for details
  102.      on how the mode is automatically set.
  103.  
  104.